home *** CD-ROM | disk | FTP | other *** search
/ Ultra Pack / UltraComputing Partner Applications.iso / SunLabs / tclTK / src / tk4.0 / porting.old < prev    next >
Text File  |  1994-12-19  |  12KB  |  325 lines
  1. This is an old version of the file "porting.notes".  It contains
  2. porting information that people submitted for Tk releases numbered
  3. 3.6 and earlier.  You may find information in this file useful if
  4. there is no information available for your machine in the current
  5. version of "porting.notes".
  6.  
  7. I don't have personal access to any of these machines, so I make
  8. no guarantees that the notes are correct, complete, or up-to-date.
  9. If you see the word "I" in any explanations, it refers to the person
  10. who contributed the information, not to me;  this means that I
  11. probably can't answer any questions about any of this stuff. In
  12. some cases, a person has volunteered to act as a contact point for
  13. questions about porting Tcl to a particular machine;  in these
  14. cases the person's name and e-mail address are listed.  I'd be
  15. happy to receive corrections or updates.
  16.  
  17. sccsid = @(#) porting.old 1.1 94/12/19 11:26:50
  18.  
  19. ---------------------------------------------
  20. DEC Alphas:
  21. ---------------------------------------------
  22.  
  23. 1. There appears to be a compiler/library bug that prevents tkTrig.c
  24. from compiling unless you turn off optimization (remove the -O compiler
  25. switch).  The problem appears to have been fixed in the 1.3-4 version
  26. of the compiler.
  27.  
  28. ---------------------------------------------
  29. HP-UX systems:
  30. ---------------------------------------------
  31.  
  32. 1. Configuration:
  33.         HP-UX Release 7.05 on a series 300 (68k) machine.
  34.         The native cc has been used for production.
  35.         X11r4 libraries and include files were taken from
  36.         internet archives, where as the server came with HPUX release 7.05.
  37.     
  38.     Problems:
  39.         Symbol table space for cc had to be increased with: -Wc,-Ns3000
  40.         tkBind.c did not compile under -O:
  41.             C1 internal error in "GetField": Set Error Detected
  42.             *** Error code 1
  43.         tkBind.c did compile without optimization (no -O).
  44.  
  45. 2. Note: if you have trouble getting xauth-style access control to work
  46. (and you'll need xauth if you want to use "send"), be sure to uncomment
  47. the line
  48.  
  49. # Vuelogin*authorize:         True
  50.  
  51. in the file /usr/vue/config/Xconfig, so that the server starts up with
  52. authorization enabled.  Also, you may have to reboot the machine in
  53. order to force the server to restart.
  54.  
  55. ---------------------------------------------
  56. SCO Unix:
  57. ---------------------------------------------
  58.  
  59. Getting Tk to run under SCO Unix:
  60.  
  61. Add a "#undef select" to tkEvent.c, and remove the reference to TK_EXCEPTION
  62. around line 460 of main.c.
  63.  
  64. Tk uses its own scheme for allocating the border colors for its 3D widgets,
  65. which causes problems when running TK on a system with "PseudoColor"
  66. display class, and a 16-cell colormap.
  67.  
  68. If you can't go to eight bitplanes, you can instead start the server with a
  69. "-static" (Xsco) or "-analog" (Xsight) option, making the display class 
  70. become "StaticColor".  This makes the entire colormap read-only, and it will
  71. return the color that most closely maps to the desired color as possible.
  72.  
  73. ---------------------------------------------
  74. Silicon Graphics systems:
  75. ---------------------------------------------
  76.  
  77. 1. Change the CC variable in the Makefile to:
  78.  
  79. CC =        cc -xansi -D__STDC__ -signed
  80.  
  81. 2. Change the LIBS variable in the Makefile to use the X11 shared library
  82.    ("-lX11_s" instead of "-lX11").
  83.  
  84. 3. Under some versions of IRIX (e.g. 4.0.1) you have to turn off
  85.    optimization (e.g.  change "-O" in CFLAGS to "-O0" or remove it
  86.    entirely) because of faulty code generation.  If the Tcl or Tk test
  87.    suites fail, turn off optimization.
  88.  
  89. 4. Add a "-lsun" switch just before "-lm" in the LIBS definition.
  90.    Under some versions of IRIX (5.1.1.3?) you'll need to omit the
  91.    "-lsun" switch, plus remove the "-lsocket" and "-lnsl" switches
  92.    added by the configure script;  otherwise you won't be able to
  93.    use symbolic host names for the display, only numerical Internet
  94.    addresses.
  95.  
  96. 5. Rumor has it that you'll also need a "-lmalloc" switch in the
  97.    LIBS definition.
  98.  
  99. 6. In IRIX 5.2 you'll have to modify Makefile to fix the following problems:
  100.     - The "-c" option is illegal with this version of install, but
  101.       the "-F" switch is needed instead.  Change this in the "INSTALL ="
  102.       definition line.
  103.     - The order of file and directory have to be changed in all the
  104.       invocations of INSTALL_DATA or INSTALL_PROGRAM.
  105.  
  106. ---------------------------------------------
  107. IBM RS/6000's:
  108. ---------------------------------------------
  109. 1. To allow ALT- sequences to work on the RS-6000, the following
  110. line should be changed in tkBind.c:
  111.  
  112.     OLD LINE:
  113.      {"Alt",    Mod2Mask,     0},
  114.     NEW LINE:
  115.      {"Alt",    Mod1Mask,     0},
  116.  
  117. ---------------------------------------------
  118. AT&T SVR4:
  119. ---------------------------------------------
  120.  
  121. 1. The first major hurdle is that SVR4's select() subtly differs
  122. from BSD select.  This impacts Tk in two ways, some of the Xlib calls
  123. make use of select() and are inherently broken and Tk itself makes
  124. extensive use of select().  The first problem can't be fixed without
  125. rebuilding one's Xlib, but can be avoided.  I intend to submit part
  126. of my work the XFree86 guys so that the next version of XFree86 for
  127. SVR4 will not be broken.  Until then, it is necessary to comment out
  128. this section of code from Tk_DoOneEvent() (which is near line 1227):
  129.  
  130. #if !defined(SVR4)
  131.                     void (*oldHandler)();
  132.  
  133.                     oldHandler = (void (*)()) signal(SIGPIPE, SIG_IGN);
  134.                     XNoOp(display);
  135.                     XFlush(display);
  136.                     (void) signal(SIGPIPE, oldHandler);
  137. #endif /* SVR4 */
  138.  
  139. if you don't comment it out, some scripts cause wish to go into
  140. an infinite loop of sending no-ops to the X server.
  141.  
  142. 2. As for fixing Tk's calls to select(), I've taken the simple
  143. approach of writing a wrapper for select and then using #define to
  144. replace all calls to select with the wrapper.  I chose tkConfig.h
  145. to load the wrapper.  So at the very end of tkConfig.h, it now looks
  146. like:
  147.  
  148. #if defined(SVR4)
  149. #  include "BSDselect.h"
  150. #endif 
  151.  
  152. #endif /* _TKCONFIG */
  153.  
  154. The file BSDselect.h looks like this:
  155.  
  156. #include <sys/types.h>
  157. #include <sys/time.h>
  158. #include <sys/select.h>
  159.  
  160. /*  This is a fix for the difference between BSD's select() and
  161.  *  SVR4's select().  SVR4's select() can never return a value larger
  162.  *  than the total number of file descriptors being checked.  So, if
  163.  *  you select for read and write on one file descriptor, and both
  164.  *  are true, SVR4 select() will only return 1.  BSD select in the
  165.  *  same situation will return 2.
  166.  *
  167.  *    Additionally, BSD select() on timing out, will zero the masks,
  168.  *    while SVR4 does not.  This is fixed here as well.
  169.  *
  170.  *    Set your tabstops to 4 characters to have this code nicely formatted.
  171.  *
  172.  *    Jerry Whelan, guru@bradley.edu, June 12th, 1993
  173.  */
  174.  
  175.  
  176. int
  177. BSDselect(nfds, readfds, writefds, exceptfds, timeout)
  178. int nfds;
  179. fd_set *readfds, *writefds, *exceptfds;
  180. struct timeval *timeout;
  181. {
  182.     int        rval,
  183.             i;
  184.  
  185.     rval = select(nfds, readfds, writefds, exceptfds, timeout);
  186.  
  187.     switch(rval) {
  188.         case -1:    return(rval);
  189.                     break;
  190.  
  191.         case 0:        if(readfds != NULL)
  192.                         FD_ZERO(readfds);
  193.                     if(writefds != NULL)
  194.                         FD_ZERO(writefds);
  195.                     if(exceptfds != NULL)
  196.                         FD_ZERO(exceptfds);
  197.  
  198.                     return(rval);
  199.                     break;
  200.  
  201.         default:    for(i=0, rval=0; i < nfds; i++) {
  202.                         if((readfds != NULL) && FD_ISSET
  203. (i, readfds)) rval++;
  204.                         if((writefds != NULL) && FD_ISSE
  205. T(i, writefds)) rval++;
  206.                         if((writefds != NULL) && FD_ISSE
  207. T(i, exceptfds)) rval++;
  208.                     }
  209.                     return(rval);
  210.         }
  211. /* Should never get here */
  212. }
  213.  
  214. ---------------------------------------------
  215. CDC 4680MP, EP/IX 1.4.3:
  216. ---------------------------------------------
  217.  
  218. The installation was done in the System V environment (-systype sysv)
  219. with the BSD extensions available (-I/usr/include/bsd and -lbsd).  It was
  220. built with the 2.20 level C compiler.  The 2.11 level can be used, but
  221. it is better to match what TCL is built with, which must be 2.20 or
  222. higher (see the porting notes with TCL for the details).
  223.  
  224. To make the configure script find the BSD extensions, I set environment
  225. variable DEFS to "-I/usr/include/bsd" and LIBS to "-lbsd" before
  226. running it.  I would have also set CC to "cc2.20", but that compiler
  227. driver has a bug that loader errors (e.g. not finding a library routine,
  228. which the script uses to tell what is available) do not cause an error
  229. status to be returned to the shell (but see the Tcl 2.1.1 porting notes
  230. for comments about using "-non_shared").
  231.  
  232. After running configure, I changed the CC definition line in Makefile
  233. from:
  234.     CC=cc
  235. to
  236.     CC=cc2.20
  237. to match the TCL build.  Skip this if the default compiler is already 2.20
  238. (or later).
  239.  
  240. ---------------------------------------------
  241. CDC 4680MP, EP/IX 2.1.1:
  242. ---------------------------------------------
  243.  
  244. The installation was done in the System V environment (-systype sysv)
  245. with the BSD extensions available (-I/usr/include/bsd and -lbsd).  It was
  246. built with the 3.11 level C compiler.  Earlier levels can be used, but it
  247. is better to match what TCL is built with, which must be 2.20 or higher
  248. (see the porting notes with TCL for the details).
  249.  
  250. To make the configure script find the BSD extensions, I set environment
  251. variable DEFS to "-I/usr/include/bsd -non_shared" and LIBS to "-lbsd"
  252. before running it.
  253.  
  254. See the Tcl porting notes for comments on why "-non_shared" is needed
  255. during the configuration step.  It was removed from AC_FLAGS before
  256. building.
  257.  
  258. -------------------------------------------------
  259. Pyramid, OSx 5.1a (UCB universe, GCC installed):
  260. -------------------------------------------------
  261.  
  262. Instead of typing "./configure" to configure, type
  263.  
  264.     DEFS="-I/usr/include/X11/attinc" ./configure
  265.  
  266. to sh to do the configuration.
  267.  
  268. -------------------------------------------------
  269. NextSTEP 3.1:
  270. -------------------------------------------------
  271.  
  272. 1. Run configure with predefined CPP:
  273.     CPP='cc -E' ./configure
  274.    (If your shell is [t]csh, do a "setenv CPP 'cc -E'")
  275.  
  276. 2. Edit Makefile: 
  277.   -add the following to AC_FLAGS:
  278.     -Dstrtod=tcl_strtod
  279.  
  280. Note: Tk's raise test may fail when running the tvtwm window manager.
  281. Changing to either twm or even better fvwm ensures that this test will
  282. succeed. 
  283.  
  284. -------------------------------------------------
  285. Encore 91, UMAX V 3.0.9.3:
  286. -------------------------------------------------
  287.  
  288. 1. Modify the CFLAGS definition in Makefile to include -DENCORE:
  289.  
  290.     CFLAGS = -O -DENCORE
  291.  
  292. 2. "mkdir" does not by default create the parent directories.  The mkdir
  293. directives should be modified to "midir -p".
  294.  
  295. 3. An error of a redeclaration of read, can be resolved by conditionally
  296. not compiling if an ENCORE system.
  297.  
  298. #ifndef ENCORE
  299. extern int              read _ANSI_ARGS_((int fd, char *buf, size_t size));
  300. #endif
  301.  
  302. -------------------------------------------------
  303. Sequent machines running Dynix:
  304. Contact: Andrew Swan (aswan@soda.berkeley.edu)
  305. -------------------------------------------------
  306.  
  307. 1. Use gcc instead of the cc distributed by Sequent
  308.  
  309. 2. There are problems with the distributed version of
  310.    <stddef.h>.  The easiest solution is probably to create a
  311.    copy of stddef.h, make sure it comes early in the include
  312.    path and then edit it as need be to eliminate conflicts
  313.    with the X11 header files.
  314.  
  315. 3. The same comments about the tanh function from the notes on
  316.    porting Tcl apply to Tk.
  317.  
  318. -------------------------------------------------
  319. Systems running Interactive 4.0:
  320. -------------------------------------------------
  321.  
  322. 1. Add "-posix" to CFLAGS in Makefile (or Makefile.in).
  323.  
  324. 2. Add "-lnsl_s" to LIBS in Makefile (or Makefile.in).
  325.